From: Chong Yidong <cyd@gnu.org>
Date: Fri, 27 Jan 2012 08:35:51 +0000 (+0800)
Subject: Minor clarification in Lisp manual about pre/post-command-hook.
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1~1^2~324^2~1096
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=55f0b898fc8dba4dfeb1c3cb629395f4788cd3f8;p=emacs.git

Minor clarification in Lisp manual about pre/post-command-hook.

* doc/lispref/commands.texi (Command Overview): Minor clarification (Bug#10384).
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 5ed7996770a..d3813acbfe3 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2012-01-27  Chong Yidong  <cyd@gnu.org>
+
+	* commands.texi (Command Overview): Minor clarification (Bug#10384).
+
 2012-01-26  Chong Yidong  <cyd@gnu.org>
 
 	* searching.texi (String Search): Document negative repeat count
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 4a0bc8a6b24..3d2b813b592 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -75,18 +75,22 @@ function yourself (@pxref{Keyboard Macros}).
 character causes @dfn{quitting} (@pxref{Quitting}).
 
 @defvar pre-command-hook
-The editor command loop runs this normal hook before each command.  At
-that time, @code{this-command} contains the command that is about to
-run, and @code{last-command} describes the previous command.
-@xref{Command Loop Info}.
+This normal hook is run by the editor command loop before it executes
+each command.  At that time, @code{this-command} contains the command
+that is about to run, and @code{last-command} describes the previous
+command.  @xref{Command Loop Info}.
 @end defvar
 
 @defvar post-command-hook
-The editor command loop runs this normal hook after each command
-(including commands terminated prematurely by quitting or by errors),
-and also when the command loop is first entered.  At that time,
-@code{this-command} refers to the command that just ran, and
-@code{last-command} refers to the command before that.
+This normal hook is run by the editor command loop after it executes
+each command (including commands terminated prematurely by quitting or
+by errors).  At that time, @code{this-command} refers to the command
+that just ran, and @code{last-command} refers to the command before
+that.
+
+This hook is also run when Emacs first enters the command loop (at
+which point @code{this-command} and @code{last-command} are both
+@code{nil}).
 @end defvar
 
   Quitting is suppressed while running @code{pre-command-hook} and